# Инструкция по установке и запуску проекта

## Описание проекта
Этот проект предназначен для скачивания информации о задачах из Jira и сохранения ее в базу данных для последующей визуализации в Power BI.

## Требования
1. Python 3 (тестировал на 3.11.5) [скачать](https://www.python.org/ftp/python/3.11.7/python-3.11.7-amd64.exe)
2. GIT [скачать](https://git-scm.com/)
3. Драйвер "PostgreSQL ODBC Driver(UNICODE)"
4. Power BI

## Установка проекта 

### Шаг 1: Клонирование репозитория
1. Перейдите в папку, в которую вы хотите клонировать проект.
2. Скачайте в неё и запустите [setup_project.bat](setup/setup_project.bat) (для Windows) или [setup_project.sh](setup/setup_project.sh) (для Mac).

### Шаг 2: Настройка конфигурационного файла
1. Переименуйте файл `_config.ini` в `config.ini` и откройте его в текстовом редакторе или скопируйте в папку проекта преднастроенную конфигурацию.
2. Заполните следующие поля в соответствии с вашими данными:
    - `URL`: URL вашего Jira-сервера.
    - `EMAIL`: Ваш адрес электронной почты для аутентификации в Jira.
    - `API_TOKEN`: Ваш API токен для доступа к Jira API.
    - `PROJECTS`: Список проектов в Jira, информацию о задачах которых вы хотите загрузить.
    - `HOST`: Адрес хоста базы данных.
    - `PORT`: Порт базы данных.
    - `DATABASE`: Имя базы данных.
    - `USER`: Имя пользователя для доступа к базе данных.
    - `PASSWORD`: Пароль пользователя для доступа к базе данных.

## Запуск скрипта
1. Запустите `run_script.bat` (для Windows) или `run_script.sh` (для Mac).

## Атрибуты запуска
Можно запросить в JIRA обновленные задачи за разные периоды времени. Для этого можно запускать скрипт с атрибутом.
Пример:
'python scripts\main.py w'


Ключи:

`d` - за день;

`w` - за неделю;

`m` - за месяц;

`q` - за квартал;

`y` - за год;

`n` - за 5 лет (за всё время);


По умолчанию задается `w`.

## Установка драйвера ODBC:
Тут есть подробное описание [ссылка](https://odbc.postgresql.org/)

Тут лежат бинарные файлы для установки в windows [ссылка](https://www.postgresql.org/ftp/odbc/versions/msi/)

## Создание подключения ODBC к базе данных:
Можно воспользоваться bat скриптом [new_odbc.bat](setup/new_odbc.bat) (Узнайте пароль к БД у администратора и вставьте в bat-файл в соответствующее поле)

Или настройте вручную:

![alt text](img/2024-03-16_21-40-31.png)

![alt text](img/2024-03-16_21-40-47.png)

![alt text](img/2024-03-16_21-41-10.png)

## Изменение подключения в Power BI:
шаг 1
![alt text](<img/изображение (2).png>)

шаг 2
![alt text](<img/изображение (3).png>)

шаг 3
![alt text](img/2024-03-16_21-45-13.png)

Далее потребуется ввести те же логин и пароль как и в ODBC подключении.
